home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / doorlist.zip / DOORLIST.DOC < prev    next >
Text File  |  1991-01-28  |  6KB  |  154 lines
  1.  
  2.  
  3. DOORLIST 1.0 : a method to keep your callers current on their games in progress
  4.  
  5. first of many SYSOP utilities coming from ...
  6.  
  7.  
  8.      ╔╦╦════[]            007LZ PCBoard 14.5/E6  7d, 24h         []════╦╦╗
  9.      ║║║                                                               ║║║
  10. ╔════╩╩╝         (313) 535-0881 . Hayes Ultra v.32  . dos files        ╚╩╩════╗
  11. ╔════╩╩╝         (313) 535-0882 . Hayes vsm9600 mnp . graphics         ╚╩╩════╗
  12. ╔════╩╩╝         (313) 535-0883 . Hayes vsm9600 mnp . games            ╚╩╩════╗
  13. ╔════╩╩╝     system nodes 4-6 are private access subscription only     ╚╩╩════╗
  14. ║                                                                             ║
  15. ║ [] Sponsored by GGM Data  Gnome Group Meetings - Done At Times Available [] ║
  16. ║                          and other Computer Stuff too!                      ║
  17. ║                                                                             ║
  18. ╚════╦╦╗       (313) 535-0880 . office ..  hours by appointment        ╔╦╦════╝
  19.      ║║║                                                               ║║║
  20.      ╚╩╩══════════════════════════[] 'O O` []══════════════════════════╩╩╝
  21.                                   []  ^^^  []
  22.                                   [][[[-]]][]
  23.  
  24.  
  25.  
  26.         LEGAL STUFF  :  (to the tune of row row row your boat)
  27.  
  28. Wrote Wrote Wrote the code, strictly for myself;
  29. should you use it and you choose it, then you're own your own
  30.  
  31.  
  32.  
  33.         REGISTRATION :  this program is free, but .... if you use it
  34.                         please let me know how far it gets by ringing
  35.                         into the system as described above.
  36.  
  37.  
  38.        HOW TO USE IT :
  39.  
  40. DOORLIST was written and compiled using QuickBasic 4.5, and needs BRUN45.exe
  41. available to it, either in the current directory, or the DOS path.
  42.  
  43. The batch files that start a door from your BBS should look something like this
  44.  
  45. @echo off
  46. cls
  47.  
  48. echo THIS DOOR > just.now   rem add this line, The file name and location is
  49.                             rem configurable, see below concerning .cfg file
  50. cd\doordir
  51. doorprog
  52. cd\bbs
  53. bbs
  54.  
  55.  
  56. Enter the program DOORLIST into the batch file that calls the BBS program when
  57. returning from a door, or into a secondary return call.. The PCBoard BOARD.BAT
  58. that I use looks something like this just before restarting the system ...
  59.  
  60. ...
  61. cd\pcb
  62. if exist door.bat call backdoor.bat
  63. pcboard
  64. ...
  65.  
  66. the backdoor.bat called there looks in part like this ...
  67.  
  68. ...
  69. if exist just.now goto showlist
  70. goto normalexit
  71. :showlist
  72. doorlist
  73. type uplayed.lst > com1
  74. del uplayed.lst
  75. :normalexit
  76. ...
  77.  
  78. The DOORLIST program will read C:\PCB\PCBOARD.SYS and extracts user number of
  79. current caller (lets say it is user #26).     It then looks for a file called
  80. C:\DOORS\26.GGM, Should that file not be found, it will be created.
  81.  
  82. It knows what door has just been entered from the file JUST.NOW created (we did
  83. do that, right?) in the current directory by each of the door startup.bat files.
  84. If it does not find JUST.NOW, the program will abort politely.
  85.  
  86. DOORLIST will then compare the current door with the list of other doors that
  87. the caller has entered, and updates the one just played with current date and
  88. time. While doing this, DOORLIST also creates the file UPLAYED.LST in the
  89. current directory.  This file, consisting of other doors used - date & time,
  90. can be displayed to the caller before returning to the BBS system, as a logon
  91. bulletin, message, or however the SYSOP would like.  I display it to a caller
  92. before returning to PC Board, and then it is deleted.
  93.  
  94. Simple, but effective.
  95.  
  96.        CONFIGURATION :
  97.  
  98. When you run DOORLIST, it is not required, but you may append a fully qualified
  99. filename for a config file.  That file must be in the following form ... which
  100. by the way, are the hardcoded defaults, and used if there is no .cfg specified.
  101.  
  102. C:\PCB\PCBOARD.SYS     : where to find PCBOARD.SYS
  103. C:\DOORS\              : where to find and store the callers lists
  104. .GGM                   : the extension to use for that file
  105. C:\PCB\JUST.NOW        : where to find the current door identification file
  106. C:\PCB\UPLAYED.LST     : file name to create that will be shown to caller
  107.  
  108.            STABILITY :
  109.  
  110. There is some minor error correction done, but remember ...
  111.  
  112.                         GARBAGE IN ...GARBAGE OUT
  113.  
  114. ...if you pass DOORLIST something it cannot use ... results will be more than
  115. unpredictable.  It works fine here with the defaults.
  116.  
  117.  
  118.     BELLS & WHISTLES :
  119.  
  120. None whatsoever, if you want to append a header or footer to the file displays,
  121. help yourself.  You got a free engine, the chrome is of your own design.
  122.  
  123.        OTHER SYSTEMS :
  124.  
  125. If you are using a system other than PC Board (why would you?) and can run a
  126. preprocessor on your caller information file (CALLINFO.BBS, DORINFOx.DEF, etc)
  127. to create a temporary PCBOARD.SYS (or other file name as per configuration of
  128. your choice) that * DOES CONTAIN THE UNIQUE USERNUMBER FOR THAT CALLER * it is
  129. possible to use DOORLIST with other BBS system.  I have not tried it, so good
  130. luck. :)
  131.  
  132.                  ETC :
  133.  
  134. Utility is first attempt at authoring for public distribution . need I say more?
  135.  
  136. Good luck, and I would really like to hear if this is working for you. As it is
  137. indeed a hassle when callers start a game, but do not call in to make or take
  138. their moves for a good amount of time, disrupting the flow of games, this is a
  139. method of keeping your callers up to date whenever they enter a door on your
  140. system.
  141.  
  142. SYSOP can also from the files created ...
  143.  
  144.       **gain greater insight to usage of board as the callers files provide an
  145.         extended log of activity that can be processed
  146.       **find out who entered a game, but have never called back at all
  147.         thereby allowing greater maintenance levels on existing  unused doors.
  148.       **determine which doors are most popular, and the flip side
  149.  
  150.  
  151. ENJOY! ...
  152.  
  153. Gary Groeller, sysop 007LZ  (313) 535 0881
  154.